home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / docs / help / aguidehowwrite.readme < prev    next >
Text File  |  1998-01-05  |  6KB  |  145 lines
  1. Short:        How To Write Amigaguide Documents
  2. Author:       bunton@acay.com.au (Frank Bunton)
  3. Uploader:     bunton@acay.com.au (Frank Bunton)
  4. Version:      01.04
  5. Type:         docs/help
  6. Replaces:     docs/help/aguidehowwrite.lha
  7. Replaces:     docs/help/aguidehowwriteN.lha
  8. Requires:     Amigaguide or Multiview
  9. Distribution: * Commercial Magazines and CDs must request permission
  10.  
  11.                 from author to include.
  12.               * Non commercially, it can be distributed anywhere.
  13.               * Aminet CDs & Fish CDs may include.
  14.  
  15. Description: 
  16. -----------
  17.  
  18. This is a comprehensive guide to writing documents in Amigaguide format.
  19. Of course, this document, itself, is in Amigaguide format ;-)
  20. So you will need either Amigaguide or Multiview to read it properly.
  21.  
  22. There are plenty of examples included and lots of cross referencing.
  23.  
  24. Differences in the various versions of the amigaguide.library and
  25. amigaguide.datatype are covered.
  26.  
  27. Changes In Version 1.04 05-12-97
  28. --------------------------------
  29.  
  30. * Oh dear oh dear!!!! - found out that Amigaguide/Multiview in Version 39
  31.   will NOT show lines which have this sequence of characters:-
  32.  
  33.      a backslash
  34.      the @ symbol
  35.      any character immediately after the @ other than space or {
  36.  
  37.   so users of version 39 had a lot of blank lines while reading this
  38.   project!!! (VERY strange as versions 34 and 40 DO show such lines!!!).
  39.  
  40.   COMPLETELY REWROTE THE WHILE PROJECT TO FIX THIS V39 PROBLEM!!
  41.  
  42. * As I have now been able to access a version 39 setup I have revised all
  43.   sections where there was doubt expressed as to how version 39 reacted. 
  44.  
  45. * I found out that there is a problem with `Retrace' with links to lines in
  46.   the same node when using version 39. I have therefore created a lot more
  47.   nodes rather than having links to lines other than the first in the node.
  48.  
  49. * Added the section on the BEEP section.
  50.  
  51. * Added a bit to the Unrecognised Commands to explain what happens when the
  52.   unrecognised command is set up similarly to link commands.
  53.  
  54. * Added section on Current Directory recognised by Amigaguide/Multiview.
  55.  
  56. * Transferred section on Links to Non Amigaguide Documents from the node
  57.   Links To Document Nodes to its own node.
  58.  
  59. * Added section on the debugging feature which resulted in a slight change
  60.   to the DATABASE section.
  61.  
  62. * Rewrote "Problem 7" when I found that versions 34 and 39 did NOT react in
  63.   the same way as I had previoulsy thought they did.
  64.  
  65. * A LOT of other minor cosmetic changes that have made no real change to the
  66.   context. These are too numerous to mention.
  67.  
  68. The contents of this archive are:-
  69. ----------------------------------
  70.  
  71.   Amigaguide_How_To_Write (Dir)
  72.     AGHTW_Boring_Stuff            20172
  73.     AGHTW_Index                   24650
  74.     AGHTW_Part1                   31112
  75.     AGHTW_Part2                   42555
  76.     AGHTW_Part3                   49865
  77.     AGHTW_Part4                   35515
  78.     AGHTW_Part5                   22413
  79.     aguidehowwrite.readme          4037
  80.     How_To_Write_Amigaguide         681
  81.     How_To_Write_Amigaguide.info   2619
  82.     Installation                   1766
  83.     Installation.info               835
  84.  
  85.   Help (Sub Dir)
  86.     ExtraNotes                     1254
  87.  
  88.   Miscellaneous (Sub Dir)
  89.     adosbegin30.readme             3189
  90.     AG_Settings                      28
  91.     amigalogo.pic                  7334
  92.     arexxbegn20.readme             3744
  93.     AssignMyProgram                  21
  94.     BasicDoc.guide                   78
  95.     Cuckoo.snd                     4810
  96.     DemoScript                      560
  97.     Demo_Of_Settings.guide          320
  98.     Demo_Of_Settings.rexx          1137
  99.     helpdoc.guide                  1018
  100.     MV_Settings                      28
  101.     Testprogram.guide               336
  102.     Testprogram_close.rexx          331
  103.     Testprogram_open.rexx           333
  104.  
  105. --------------------------------------------------------------------
  106. Frank Bunton   bunton@acay.com.au    http://www.acay.com.au/~bunton
  107. --------------------------------------------------------------------
  108.  
  109.  
  110. ============================= Archive contents =============================
  111.  
  112. Original  Packed Ratio    Date     Time    Name
  113. -------- ------- ----- --------- --------  -------------
  114.    24650    4668 81.0% 03-Dec-97 13:39:36 +AGHTW_Index
  115.    31112    9559 69.2% 03-Dec-97 14:12:24 +AGHTW_Part1
  116.    42555   12875 69.7% 03-Dec-97 15:29:10 +AGHTW_Part2
  117.    49865   15058 69.8% 03-Dec-97 15:52:54 +AGHTW_Part3
  118.    35515    8911 74.9% 03-Dec-97 16:24:58 +AGHTW_Part4
  119.    22413    7578 66.1% 03-Dec-97 16:30:50 +AGHTW_Part5
  120.     1254     639 49.0% 03-Nov-97 16:29:58 +ExtraNotes
  121.      681     406 40.3% 18-Sep-97 10:01:46 +How_To_Write_Amigaguide
  122.     2619     668 74.4% 03-Sep-97 15:39:26 +How_To_Write_Amigaguide.info
  123.     1766     646 63.4% 04-Dec-97 12:53:38 +Installation
  124.       28      27  3.5% 21-Sep-97 10:20:14 +AG_Settings
  125.       21      21  0.0% 02-Sep-97 13:19:20 +AssignMyProgram
  126.       78      73  6.4% 17-Sep-97 16:04:14 +BasicDoc.guide
  127.      320     219 31.5% 24-Sep-97 21:56:44 +Demo_Of_Settings.guide
  128.     1137     494 56.5% 24-Sep-97 22:34:12 +Demo_Of_Settings.rexx
  129.       28      28  0.0% 19-Sep-97 13:52:06 +MV_Settings
  130.     3189    1431 55.1% 07-Jul-97 11:58:04 +adosbegin30.readme
  131.     7334    3051 58.3% 26-Nov-85 01:50:04 +amigalogo.pic
  132.     3744    1617 56.8% 21-Mar-97 08:44:04 +arexxbegn20.readme
  133.     4810    4504  6.3% 27-Sep-93 22:21:52 +Cuckoo.snd
  134.      560     329 41.2% 16-Sep-97 14:06:40 +DemoScript
  135.     1018     524 48.5% 03-Dec-97 15:45:10 +helpdoc.guide
  136.      336     237 29.4% 25-Oct-96 16:10:22 +Testprogram.guide
  137.     2532     610 75.9% 03-Sep-97 15:39:26  Amigaguide_How_To_Write.info
  138.    20172    7475 62.9% 04-Dec-97 12:51:36 +AGHTW_Boring_Stuff
  139.     4037    1663 58.8% 04-Dec-97 12:54:22 +aguidehowwrite.readme
  140.      835     247 70.4% 03-Sep-97 15:39:26 +Installation.info
  141.      331     248 25.0% 31-Jul-97 13:50:20 +Testprogram_close.rexx
  142.      333     249 25.2% 31-Jul-97 13:50:42 +Testprogram_open.rexx
  143. -------- ------- ----- --------- --------
  144.   263273   84055 68.0% 04-Dec-97 22:26:48   29 files
  145.